home *** CD-ROM | disk | FTP | other *** search
/ Nothing but GIFs AGA / Nothing But GIFs.iso / immogrif.lha / imagemagick / README < prev    next >
Text File  |  1995-07-03  |  17KB  |  531 lines
  1.   "I swear by my life and my love of it that I will never live
  2.    for the sake of another man, nor ask another man to live for
  3.    mine."
  4.  
  5.                     John Galt in "Atlas Shrugged", by Ayn Rand
  6.  
  7.  
  8. AUTHOR
  9.  
  10.   The author is cristy@dupont.com.  This software is NOT
  11.   shareware.  However, I am interested in who might be using
  12.   it.  Please consider sending me a picture postcard of the area
  13.   where you live.  Send postcards to
  14.  
  15.     John Cristy
  16.     5 Middleton Lane
  17.     Landenberg, PA  19350
  18.     USA
  19.  
  20.  
  21. AVAILABILITY
  22.  
  23.   ImageMagick is available as
  24.  
  25.     ftp://ftp.x.org/contrib/applications/ImageMagick/ImageMagick-3.6.3.tar.gz
  26.  
  27.   I want ImageMagick to be of high quality, so if you encounter
  28.   a problem I will investigate.  However, be sure you are using
  29.   the most recent version from ftp.x.org before submitting any
  30.   bug reports or suggestions.
  31.  
  32.  
  33. WWW
  34.  
  35.   The official ImageMagick WWW page is
  36.  
  37.     http://www.wizards.dupont.com/cristy/ImageMagick.html
  38.  
  39.   it was created and is maintained by muquit@warm.semcor.com.
  40.   The page is currently a work-in-progress and will mostly be
  41.   complete by July 1995.  Another useful ImageMagick WWW page is
  42.  
  43.     http://www.vrl.com/Imaging/
  44.  
  45.   To use display as your external image viewer, edit the global mailcap
  46.   file or your personal mailcap file .mailrc (located at your home
  47.   directory) and put this entry:
  48.  
  49.  
  50.     image/*; display %s
  51.  
  52.  
  53. UNIX COMPILATION
  54.  
  55.   Type:
  56.  
  57.     gunzip ImageMagick-3.6.3.tar.gz
  58.     tar xvf ImageMagick-3.6.3.tar
  59.     cd ImageMagick
  60.     < edit magick/X.h and verify the RGBColorDatabase define >
  61.     xmkmf
  62.     make Makefiles
  63.     make depend
  64.     make -k
  65.  
  66.   If you do not have gunzip(1), it is available as
  67.   prep.ai.mit.edu:pub/gnu/gzip-1.2.4.shar.  If you do not have
  68.   xmkmf(1), or if xmkmf(1) fails to produce usable Makefiles,
  69.   type
  70.  
  71.     configure
  72.     make
  73.  
  74.   Finally type:
  75.  
  76.     display images/aquarium.miff
  77.     display -monochrome -dither images/aquarium.miff
  78.  
  79.   The aquarium and other images are available from anonymous FTP
  80.   at ftp.x.org, file
  81.   contrib/applications/ImageMagick/ImageMagick.images.tar.gz.
  82.  
  83.   If the image colors are not correct use this command:
  84.  
  85.     display -visual default images/aquarium.miff
  86.  
  87.   You can find other example images in the 'images' directory.
  88.  
  89.   Be sure to read the manual pages for the display(1), animate(1),
  90.   montage(1), import(1), mogrify(1), identify(1), segment(1),
  91.   combine(1), and convert(1) utilities.  Also read the ImageMagick
  92.   frequently asked questions in the file Magick.faq.  This is required
  93.   reading.  Most of the questions I get via electonic mail are answered
  94.   in this document.
  95.  
  96.   Place display(1) X application defaults in
  97.   /usr/lib/X11/app-defaults/Display.  Use the appropriate name
  98.   for other clients (e.g. Animate, Montage, etc).
  99.  
  100.   The ImageMagick utilities read and write MIFF images.  Refer
  101.   to the end of this message for more information about MIFF.
  102.   Use convert(1) to convert images to and from the MIFF format.
  103.  
  104.   ImageMagick utilities recognizes these image formats:
  105.  
  106.        Tag       Description
  107.        ----------------------------------------------------
  108.        AVS       AVS X image file
  109.        BMP       Microsoft Windows bitmap image file
  110.        CMYK      Raw cyan, magenta, yellow, and black bytes
  111.        EPS       Adobe Encapsulated Postscript
  112.        FAX       Group 3
  113.        FITS      Flexible Image Transport System
  114.        GIF       Compuserve Graphics image file
  115.        GRAY      Raw gray bytes
  116.        HDF       Hierarchical Data Format.
  117.        JPEG      Joint Photographic Experts Group file interchange format
  118.        MAP       colormap intensities and indices
  119.        MATTE     Raw matte bytes
  120.        MIFF      Magick image file format
  121.        MPEG      Motion Picture Experts Group digital video
  122.        MTV       MTV ray tracer image format
  123.        PCD       Photo CD
  124.        PCX       ZSoft IBM PC Paintbrush file
  125.        PDF       Portable Document Format
  126.        PICT      Apple Macintosh QuickDraw/PICT file
  127.        PNG       Portable Network Graphics
  128.        PNM       Portable bitmap
  129.        PS        Adobe PostScript file
  130.        PS2       Adobe PostScript Level II file
  131.        RAD       Radiance image file
  132.        RGB       Raw red, green, and blue bytes
  133.        RLE       Utah Raster Toolkit
  134.        SUN       SUN Raster image file format
  135.        TGA       Truevision Targa image file
  136.        TEXT      raw text file;  read only
  137.        TIFF      Tagged Image File Format
  138.        VICAR     Planetary File Format
  139.        VID       Visual Image Directory
  140.        VIFF      Khoros Visualization image file
  141.        X         select image from X server screen
  142.        XC        constant image of X server background color
  143.        XBM       X11 bitmap
  144.        XPM       X11 pixmap
  145.        XWD       X11 window dump
  146.        YUV       CCIR 601 4:1:1 file.
  147.        YUV3      CCIR 601 4:1:1 files.
  148.  
  149.   and for your convenience automatically converts most of these
  150.   alien image format to MIFF at execution time.  However, the
  151.   MIFF image format has several advantages over most image
  152.   formats (i.e. runlength encoding, visual image dorectories, digital
  153.   signature on an image colormap, etc.).  ImageMagick is designed to
  154.   exploit these advantages.  Whenever possible convert an alien image
  155.   format to the MIFF format before using the various ImageMagick
  156.   programs.
  157.  
  158.   Other formats may also be recognized.  See CONVERT(1) for a
  159.   list of valid image formats.  You can specify a particular
  160.   image format by prefixing the image filename with the image
  161.   type and a colon (i.e.  ps:image).
  162.  
  163.   To further enhance the capabilities of ImageMagick, you may
  164.   want to get these programs or libraries:
  165.  
  166.   o ImageMagick requires GNU's Ghostscript software available
  167.     via anonymous FTP as
  168.  
  169.       ftp://ftp.cs.wisc.edu/pub/ghost/aladdin/ghostscript-3.33.tar.gz
  170.  
  171.     to read the Postscript or the Portable Document format.  For
  172.     ImageMagick to read Postscript files, gs(1) must be in your
  173.     execution path and the `pbmraw' and `ppmraw' devices must be
  174.     recognized (try gs -h to verify).  If they are not defined,
  175.     add them to your DEVICE_DEVS define in your Ghostscript
  176.     Makefile and recompile (i.e. DEVICE_DEVS=x11.dev pbmraw.dev
  177.     ppmraw.dev).  For ImageMagick to read Portable Document
  178.     Format files, the PDF language interpreter must be
  179.     recognized (try gs -h to verify).  If PDF is not
  180.     interpreted, add pdf.dev to the FEATURE_DEVS define in your
  181.     Ghostscript Makefile and recompile.
  182.  
  183.   o ImageMagick requires the NCSA HDF library
  184.     available via anonymous FTP as
  185.  
  186.       ftp://ftp.ncsa.uiuc.edu/HDF/HDF3.3r4/tar/HDF3.3r4.tar.Z
  187.  
  188.     to read and write the HDF image format.
  189.  
  190.   o ImageMagick requires the JBIG-Kit software available via anonymous
  191.     FTP as
  192.  
  193.       ftp://ftp.uni-erlangen.de/pub/doc/ISO/JBIG/jbigkit-0.7.tar.gz
  194.  
  195.     to read the JBIG image format.
  196.  
  197.   o ImageMagick requires the Independent JPEG Group's software
  198.     available via anonymous FTP as
  199.  
  200.       ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v5b.tar.gz
  201.  
  202.     to read the JPEG image format.
  203.  
  204.   o ImageMagick requires the MPEG library available via
  205.     anonymous FTP as
  206.  
  207.       ftp://ftp.mni.mcgill.ca/pub/mpeg/mpeg_lib-1.1.tar.gz
  208.       ftp://wpi.wpi.edu/contrib/mpeg_lib-1.1.tar.gz
  209.  
  210.     to read the MPEG image format.
  211.  
  212.   o ImageMagick requires picttoppm from
  213.  
  214.       ftp://ftp.x.org/R5contrib/netpbm-1mar1994.tar.gz
  215.  
  216.     to read Macintosh PICT images.
  217.  
  218.   o ImageMagick requires the PNG and ZLIB library from
  219.  
  220.       ftp://ftp.uu.net/graphics/png/code/pnglib-0.6.tar.gz
  221.       ftp://ftp.uu.net/pub/archiving/zip/zlib/zlib-0.92.tar.gz
  222.  
  223.     to read the PNG image format.  PNGlib has a bug.  Remove the
  224.     extra rp++ in routine png_write_image of pngwrite.c.
  225.  
  226.   o ImageMagick requires ra_ppm from Greg Ward's Radiance
  227.     software available via anonymous FTP as
  228.  
  229.       ftp://hobbes.lbl.gov/Radiance2R4.tar.Z
  230.  
  231.     to read the Radiance image format.
  232.  
  233.   o ImageMagick requires rawtorle from the Utah Raster Toolkit
  234.     available via anonymous FTP as
  235.  
  236.       ftp://ftp.uu.net/graphics/urt/urt-3.1b.tar.Z-split/part??
  237.  
  238.     to write the RLE image format.
  239.  
  240.   o ImageMagick requires Sam Leffler's TIFF software available
  241.     via anonymous FTP as
  242.  
  243.       ftp://sgi.com/graphics/tiff/tiff-v3.4beta004-tar.gz
  244.  
  245.     to read the TIFF image format.
  246.  
  247.   o ImageMagick requires Arnaud Le Hors XPM software available
  248.     via anonymous FTP as
  249.  
  250.       ftp://ftp.x.org/contrib/libraries/xpm-3.4f.tar.gz
  251.  
  252.     to read the XPM image format.
  253.  
  254.   o ImageMagick requires get(1) available via anonymous FTP as
  255.  
  256.       ftp://liege.ics.uci.edu/pub/arcadia/libwww-perl/
  257.  
  258.     or via Mosaic as
  259.  
  260.       http://www.ics.uci.edu/WebSoft/libwww-perl/
  261.  
  262.     to read images specified with a World Wide Web (WWW) uniform
  263.     resource locator (URL).  Get(1) must be in /usr/local/bin.
  264.     See WWWcommand in magick/image.h to change its location.  If
  265.     you do not have a HTTP server, you can use xtp(1), available
  266.     in the ImageMagick distribution, for URL's whose protocol is
  267.     FTP.
  268.  
  269.   o ImageMagick requires a background texture for the TILE
  270.     format and for the -texture option of montage(1).  You can
  271.     use your own or get samples from
  272.  
  273.       http://www.europa.com/~yyz/textures/textures.html
  274.       http://the-tech.mit.edu/cgi-bin/KPT_bgs.pl
  275.  
  276.   To display images in the HDF, JBIG, JPEG, MPEG, PNG, TIFF, or XPM
  277.   format, get the respective archive and build ImageMagick as follows:
  278.  
  279.   HDF:
  280.     cd ImageMagick
  281.     mkdir hdf
  282.     cd hdf
  283.     zcat HDF3.3r4.tar.Z | tar xvf -
  284.     cp HDF3.3r4/hdf/src/* .
  285.     < edit Makefile; define machine type; for Solaris 2.?
  286.       comment out memory.h in hdf/hdfi.h >
  287.     make libnofortran
  288.     cd ..
  289.  
  290.   JBIG:
  291.     cd ImageMagick
  292.     gunzip -c jbigkit-0.7.tar.gz | tar xvof -
  293.     mv jbigkit jbig
  294.     cd jbig
  295.     make
  296.     cd ..
  297.  
  298.   JPEG:
  299.     cd ImageMagick
  300.     gunzip -c jpegsrc.v5b.tar.gz | tar xvof -
  301.     mv jpeg-5b jpeg
  302.     cd jpeg
  303.     configure CC=cc -with-maxmem=7
  304.     make
  305.     cd ..
  306.  
  307.   MPEG:
  308.     cd ImageMagick
  309.     mkdir mpeg
  310.     cd mpeg
  311.     gunzip -c mpeg_lib-1.1.tar.gz | tar xvof -
  312.     mv mpeg_lib/* .
  313.     < edit Makefile as instructed; for Solaris use the
  314.       BSD-compatibility libraries or replace bzero with a call to
  315.       memset >
  316.     make
  317.     cd ..
  318.  
  319.   PNG:
  320.     cd ImageMagick
  321.     gunzip -c zlib-1.0.tar.gz | tar xvf -
  322.     cd zlib
  323.     make
  324.     cd ..
  325.     mkdir png
  326.     cd png
  327.     unzip -aL pnglib-1.0.zip
  328.     make
  329.     mv pnglib.a libpng.a
  330.     cd ..
  331.  
  332.   TIFF:
  333.     cd ImageMagick
  334.     gunzip -c tiff-v3.4beta004.src.tar.Z | tar xvof -
  335.     mv tiff-v3.4beta004 tiff
  336.     cd tiff
  337.     configure
  338.     make
  339.     cd ..
  340.  
  341.   XPM:
  342.     cd ImageMagick
  343.     mkdir xpm
  344.     cd xpm
  345.     gunzip -c xpm-3.4f.tar.gz | tar xvof -
  346.     mv xpm-3.4f/lib/* .
  347.     xmkmf
  348.     make
  349.     cd ..
  350.  
  351.     If your computer system supports shared libraries you must
  352.     type
  353.  
  354.       make install
  355.  
  356.     If you do not have root privileges, type this instead
  357.  
  358.       rm libXpm*
  359.       make -f Makefile.noX
  360.  
  361.   Finally, perform the following:
  362.  
  363.     cd ImageMagick
  364.     < edit Magick.tmpl and define Has???? as instructed >
  365.     xmkmf
  366.     make Makefiles
  367.     make clean
  368.     make
  369.  
  370.   If you do not have xmkmf, try
  371.  
  372.     < edit Makefile.in and define Has???? as instructed >
  373.     configure
  374.     make clean
  375.     make -k
  376.  
  377.   You can now display images in the HDF, JPEG, MPEG, TIFF, or
  378.   XPM format.
  379.  
  380.   If you have HDF, JPEG, MPEG, PNG, TIFF, and XPM sources
  381.   installed as directed above, you can also type
  382.  
  383.     Install sun
  384.  
  385.   Substitute the appropriate machine type (aix, hpux, sgi, etc).
  386.  
  387.  
  388. VMS COMPILATION
  389.  
  390.   Type
  391.  
  392.     @make
  393.     set display/create/node=node_name::
  394.  
  395.   where node_name is the DECNET X server to contact.
  396.  
  397.   Finally type:
  398.  
  399.     display [.images]aquarium.miff
  400.     display -monochrome -dither [.images]aquarium.miff
  401.  
  402.   Alternatively, get a zipped distribution (with JPEG, MPEG,
  403.   TIFF, and XPM) from
  404.  
  405.     ftp://ftp.x.org/contrib/vms/ImageMagick/ImageMagick-3.6.3.zip
  406.  
  407.   The VMS JPEG, TIFF, and XPM source libraries are available on
  408.   axp.psl.ku.dk in [anonymous.decwindows.lib].
  409.  
  410.   Thanks to pmoreau@cenaath.cena.dgac.fr for supplying
  411.   invaluable help as well as the VMS versions of the JPEG, MPEG,
  412.   TIFF, and XPM libraries.
  413.  
  414.  
  415. ANIMATION
  416.  
  417.   An example animation sequence is available from anonymous FTP
  418.   at ftp.x.org, file contrib/ImageMagick.animation.tar.gz.  Or
  419.   alternatively, you can create this sequence yourself.  Just
  420.   look at README in the scenes directory.
  421.  
  422.   To prevent color flashing on visuals that have colormaps,
  423.   animate(1) creates a single colormap from the image sequence.
  424.   This can be rather time consuming.  You can speed this
  425.   operation up by reducing the colors in the image before you
  426.   `animate' them.  Use mogrify(1) to color reduce the images:
  427.  
  428.     mogrify -colors 256 scenes/dna.[0-9]*
  429.  
  430.   Note, the image sequence in ImageMagick.animation.tar.gz is
  431.   already reduced.  Alternatively, you can use a Standard
  432.   Colormap; or a static, direct, or true color visual.  You can
  433.   define a Standard Colormap with xstdcmap(1).  For example, to
  434.   use the "best" Standard Colormap, type:
  435.  
  436.     xstdcmap -best
  437.     animate -map best scenes/dna.[0-9]*
  438.  
  439.   or to use a true color visual:
  440.  
  441.     animate -visual truecolor scenes/dna.[0-9]*
  442.  
  443.   Image filenames can appear in any order on the command line if
  444.   the scene keyword is specified in the MIFF image.  Otherwise
  445.   the images display in the order they appear on the command
  446.   line.  A scene is specified when converting from another image
  447.   format to MIFF by using the "scene" option with any filter.
  448.   Be sure to choose a scene number other than zero.  For
  449.   example, to convert a TIFF image to a MIFF image as scene #2,
  450.   type:
  451.  
  452.     convert -scene 2 image.tiff image.miff
  453.  
  454.  
  455. MIFF IMAGE FORMAT
  456.  
  457.   MIFF is an image format which I developed.  I like it because
  458.  
  459.     1) It is machine independent.  It can be read on virtually
  460.        any computer.  No byte swapping is necessary.
  461.  
  462.     2) It has a text header.  Most image formats are coded in
  463.        binary and you cannot easily tell attributes about the
  464.        image.  Use more(1) on MIFF image files and the
  465.        attributes are displayed in text form.
  466.  
  467.     3) It can handle runlength-encoded images.  Although most
  468.        scanned images do not benefit from runlength-encoding,
  469.        most computer-generated images do.  Images of mostly
  470.        uniform colors have a high compression ratio and
  471.        therefore take up less memory and disk space.
  472.  
  473.     4) It allows a scene number to be specified.  This allows
  474.        you to specify an animation sequence out-of-order on the
  475.        command line.  The correct order is determined by the
  476.        scene number of each image.
  477.  
  478.     5) MIFF computes a digital signature for colormapped
  479.        images.  This is useful for animating a sequence of
  480.        images on a colormapped X server.  If all signatures
  481.        match in the image sequence, computing a global colormap
  482.        is not necessary.
  483.  
  484.     6) There is a `montage' keyword allowing an image to act as
  485.        a visual image directory.  See display(1) for more details.
  486.  
  487.   One way to get an image into MIFF format is to use
  488.   convert(1).  or read it from an X window using the 'import'
  489.   program.  Alternatively, type the necessary header information
  490.   in a file with a text editor.  Next, dump the binary bytes
  491.   into another file.  Finally, type
  492.  
  493.     cat header binary_image | display -write image.miff -
  494.  
  495.   For example, suppose you have a raw red, green, blue image
  496.   file on disk that is 640 by 480.  The header file would look
  497.   like this:
  498.  
  499.     id=ImageMagick columns=640 rows=480 :
  500.  
  501.   The image file would have red, green, blue tuples
  502.   (rgbrgbrgb...).
  503.  
  504.   Refer to the display(1) manual page for more details.
  505.  
  506. COPYRIGHT
  507.  
  508.   Copyright 1995 E. I. du Pont de Nemours and Company
  509.  
  510.   Permission to use, copy, modify, distribute, and sell this
  511.   software and its documentation for any purpose is hereby
  512.   granted without fee, provided that the above copyright notice
  513.   appear in all copies and that both that copyright notice and
  514.   this permission notice appear in supporting documentation, and
  515.   that the name of E. I. du Pont de Nemours and Company not be
  516.   used in advertising or publicity pertaining to distribution of
  517.   the software without specific, written prior permission.  E.
  518.   I. du Pont de Nemours and Company makes no representations
  519.   about the suitability of this software for any purpose.  It is
  520.   provided "as is" without express or implied warranty.
  521.  
  522.   E. I. du Pont de Nemours and Company disclaims all warranties
  523.   with regard to this software, including all implied warranties
  524.   of merchantability and fitness, in no event shall E. I. du
  525.   Pont de Nemours and Company be liable for any special,
  526.   indirect or consequential damages or any damages whatsoever
  527.   resulting from loss of use, data or profits, whether in an
  528.   action of contract, negligence or other tortious action,
  529.   arising out of or in connection with the use or performance of
  530.   this software.
  531.